<?php
/*
    Download page
    Copyright (C) 2015  Leah Woods <info@minifree.org>

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as
    published by the Free Software Foundation, either version 3 of the
    License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/
	header('Content-type: text/html; charset=utf-8');
	ob_start();
	include_once "../common/variables.php";
	include_once "../common/functions.php";
?>
<!DOCTYPE html>
<html>
<head>
	<link rel="stylesheet" type="text/css" href="../common/css/main.css" />
	<title><?php echo gettext("Download libreboot"); ?></title>
</head>

<body>

	<div>

		<h1><?php echo gettext("Download libreboot (stable releases)"); ?></h1>

			<p>
				<strong>
					<?php echo gettext("The latest stable release is"); ?> <?php echo $lbRelease[0][0][0]; ?>,
					<?php echo gettext("released on"); ?> <?php echo $lbRelease[0][0][1]; ?> and can be
                    found at <a href="#https">#https</a>.
				</strong> <a href="../"><?php echo gettext("Back to home page"); ?></a>
			</p>
            <p>
                <strong>The current stable release is quite old at this point. We're working on a new release,
                and welcome everyone to get involved in testing for bugs in the <a href="#unstable">unstable releases</a>
                which are up to date and usually updated at least once every week.</strong>
            </p>
            <p>
				If you're more interested in libreboot development, go to the <a href="../git/">libreboot development page</a>, which
				also includes links to the Git repositories. <strong>For a list of tasks remaining for the next stable release
                of libreboot, see <a href="#tasks">#tasks</a>. Help is appreciated!</strong>
			</p>

			<h2>Do you have a mirror?</h2>
				<p>
					Let us know! We will add it here. Instructions for how to mirror libreboot
					releases can be found <a href="../rsync/">here</a>.
				</p>

            <h2 id="https">HTTPS mirrors</h2>
                <p>
                    These mirrors are recommended, since they use TLS (https://) encryption.
                </p>
<?php
                echo mirrorList($lbHttpsMirror, gettext("HTTPS mirrors not added yet."),0,count($lbHttpsMirror));
?>
			<h2 id="http">HTTP mirrors</h2>
                <p>
                    WARNING: these mirrors are non-HTTPS which means that they are unencrypted. Your traffic could be subject
                    to interference by adversaries. Make especially sure to check the GPG signatures, assuming
                    that you have the right key. Of course, you should do this anyway, even if
                    using HTTPS.
                </p>
<?php
				/* show HTTP mirrors */
				echo mirrorList($lbHttpMirror, gettext("HTTP mirrors not added yet."),0,count($lbHttpMirror));
?>
			<h2 id="ftp">FTP mirrors</h2>
                <p>
                    WARNING: FTP is also unencrypted, like HTTP. The same risks are present.
                </p>
<?php
				/* show FTP mirrors */
				echo mirrorList($lbFtpMirror,gettext("FTP mirrors not added yet."),0,count($lbFtpMirror));
?>
	</div>

	<div>
		<h1 id="unstable">Download libreboot (unstable/beta releases)</h1>
			<p style="font-size:120%">
				<strong>WARNING: there is no guarantee that these releases will work. They may even render your system unusable (brick it).
				Proceed with caution.</strong>
			</p>
			<p>
				<a href="../beta/">Download the unstable releases here</a> (snapshot archives, with ROM images compiled).
                This is useful if you want to help with testing for bugs/regressions before release, or if you just
                want to run the latest version of libreboot compiled from the current git repository.
			</p>
            <p>
				Over time, stable libreboot release cycles have become much slower, due to more boards being supported
				and more work being done, which means a lot more testing/fixing needs to be done before each release. 
				Therefore, we now offer unstable releases in between stable releases.
				These releases are updated fairly regularly, built from the latest version of libreboot
				from the <a href="../git/">git repository</a>.
			</p>
            <h2 id="tasks">Work to do for the next stable release of libreboot (<a href="#tasks">#tasks</a>):</h2>
    			<p>
    				Go to the <a href="../git/">libreboot development page</a>, which
    				also includes links to the Git repositories. This shows how to submit patches.
    			</p>
                <p>
                    Fix uneven backlight levels when turning brightness down on all thinkpads.
                </p>
                <p>
                    Fix broken suspend on GM45 thinkpads (regression in coreboot. Will require bisect. It works in libreboot 20150518).
                </p>
                <p>
                    Make sure that the KCMA-D8 and KGPE-D16 ports are stable. Make sure generally that all boards work properly and are stable.
                </p>
            <h2>OPTIONAL (but very desirable) work to do before the next release of libreboot, if possible:</h2>
                <p>
                    BARELY OPTIONAL (and extremely desirable): reproducible builds.
                </p>
                <p>
                    OPTIONAL (but desirable): fix broken text-mode graphics initialization on GM45 laptops
                    (framebuffer mode works. Lack of text-mode means that memtest86+ is not usable easily).
                </p>
                <p>
                   OPTIONAL (but desirable): fix screen compatibility issues on some GM45 thinkpads
                   (see <a href="http://libreboot.org/docs/hcl/gm45_lcd.html">this page</a>)
                   and some T60 laptops (see <a href="../docs/future/index.html#lcd_i945_incompatibility,future/index.html#lcd_i945_incompatibility">this page</a>).
                   For GM45 thinkpads, look at these pages (coreboot is doing something wrong companed to the linux kernel):
                   <a href="https://lists.freedesktop.org/archives/intel-gfx/2012-March/015349.html">this</a>,
                   <a href="https://lists.freedesktop.org/archives/intel-gfx/2012-March/015350.html">this</a>, and
                   <a href="https://lists.freedesktop.org/archives/intel-gfx/2012-March/015351.html">this</a>
                   - check whether coreboot is doing this
                </p>
                <p>
                    OPTIONAL (but desirable): re-write ich9gen/ich9deblob to be portable. It currently assumes endiannesses, uses bitfields, etc.
                    It's not portable at all, but works on x86 and little-endian ARM in most cases.
                </p>
                <p>
                    DUBIOUSLY OPTIONAL (actually probably required, and very desirable): Get more RK3288 and Tegra chromebooks supported.
                    PaulK is interested in this, and needs funding to get the hardware. PaulK's contact details can be
                    found in the <a href="../contrib/">contrib</a> page.
                    This could take months though, so probably won't be done before the next release.
                </p>
				<ul class="c">
                    <li>
                        The documentation is now fully converted to Texinfo. All we need now are
                        build scripts, e.g.:<br/>
                        <ul>
                            <li>./build docs html</li>
                            <li>./build docs html-onepage</li>
                            <li>./build docs pdf</li>
                            <li>etc</li>
                        </ul>
                    </li>
                    <li>
						Modify the build system, to make use of standard GNU utilities: make, autoconf and so on. The current build system is 
						non-standard (but well documented), written mostly in BASH.Read these documents:
						<ul>
							<li><a href="https://www.gnu.org/prep/standards/html_node/Standard-Targets.html">https://www.gnu.org/prep/standards/html_node/Standard-Targets.html</a></li>
							<li><a href="https://www.gnu.org/prep/maintain/maintain.html#Distributions">https://www.gnu.org/prep/maintain/maintain.html#Distributions</a></li>
						</ul>
					</li>
					<li>
                                        Modify the build system, to
					directly download the
					build dependencies
					that libreboot
					currently tells the
					user to install from
					their distribution
					package repository.
					(Only in Git. Release
					archives would have
					them already). Build
					these from source,
					with our own GCC
					(re-using coreboot's
					GCC, which libreboot
					already uses). This
					will make <em>complete
					corresponding
					source</em> provision
					easier, because it
					would be automated;
					this is in contrast to
					the present setup,
					where the person
					distributing binaries
					has to include the
					sources for build
					dependencies from the
					distribution that they
					happened to use for
					compiling those
					packages.
                                                
						<ul>
							<li>This will also make everything self-contained, and coreboot already has integration for cross-compiling. We can make cross compilation
							of utilities for non-x86 architectures much easier, without relying on quirks from the user's GNU/Linux distribution, where the
							only thing we need from their distribution is the necessary toolchain for building <em>libreboot's own version of GCC</em>, which would then take over</li>
							<li>
								However, do not install these dependencies, only self-host them in the libreboot source archive. Also provide an option for the user to ignore libreboot's
								GCC and dependencies, and use what their GNU/Linux distribution provides, when building from source.
							</li>
						</ul>
					</li>
				</ul>

	</div>

<?php
	include "../common/ccs.php";
	include "../common/footer.php";
?>

</body>
</html>
<?php
	$strHtml = ob_get_clean();
	echo miniHtml($strHtml);
?>
